home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / btrieve / xqlwrq.exe / XQLWRQ.TXT < prev   
Text File  |  1993-11-18  |  7KB  |  161 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              XQL Windows DLL 3.00c WXQLCALL.DLL
  5. DOCUMENT ID:        TID000452
  6. DOCUMENT REVISION:  B
  7. DATE:               17NOV93
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         XQLWRQ.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. XQL for DOS 2.11
  14.  
  15. ABSTRACT:
  16.  
  17. This file contains the latest XQL Windows DLL 3.00c for use with DPMI patched
  18. XQL for DOS 2.11.
  19.  
  20. ──────────────────────────────────────────────────────────────────────────────
  21. DISCLAIMER
  22. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  23. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  24. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  25. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  26. ──────────────────────────────────────────────────────────────────────────────
  27.  
  28. SYMPTOM
  29.  
  30.      Users need general use information and installation instructions for
  31.      NetWare SQL 3.0 Requester for Windows (WXQLCALL.DLL) with XQL 2.11.
  32.  
  33. SOLUTION
  34.  
  35.      Apply XQLWRQ.EXE and follow the installation instructions.
  36.  
  37.      Solution Specifics:
  38.  
  39.      General Information
  40.  
  41.      This document describes how to install and use the NetWare SQL 3.0
  42.      Requester for Windows (WXQLCALL.DLL) with XQL 2.11.  The NetWare SQL
  43.      Requester for Windows is an interface that uses the DOS Protected Mode
  44.      Interface (DPMI) that Windows provides to access XQL, which runs in real
  45.      mode.
  46.  
  47.      Critical Information
  48.  
  49.      Although you should read this entire file, pay special attention to this
  50.      section.  It contains information critical to your success in using
  51.      WXQLCALL.DLL.
  52.  
  53.      You can use XQL 2.x to develop and run applications using WXQLCALL.DLL
  54.      3.00c. If you want to run these applications in a NetWare environment,
  55.      you must upgrade or purchase NetWare SQL 3.0.  (You can also use NetWare
  56.      SQL 3.0 to develop applications using WXQLCALL.DLL 3.00c)
  57.  
  58.      Developing Your Application
  59.  
  60.      This section discusses information pertinent to languages you may use to
  61.      develop XQL applications.
  62.  
  63.      Developing Your Application with C
  64.  
  65.      The header file NWSQLAPI.H contains the prototype definitions for the XQL
  66.      APIs (application programming interface); therefore, you should include
  67.      this header file in your application source files to ensure that the
  68.      correct calling sequence exists for interfacing with the XQL APIs. 
  69.      NWSQLAPI.H includes the header file NWSQLINTH, which contains environment
  70.      configuration parameters.
  71.  
  72.      In NWSQLINT.H, set the operating system environment to Windows in section
  73.      1, "OS Environment," and define which C compiler you are using in section
  74.      2, "C Compiler."  In NetWare SQL 3.0, the levels   of API support have
  75.      new names.  The SQL-level functions correspond to XQLM, and the
  76.      relational primitives correspond to XQLP.  By default, both API levels
  77.      are defined in section 3, "API Level Support."
  78.  
  79.      After compiling your Windows application, link it with the import library
  80.      WXQLCALL.LIB.
  81.  
  82.      Note:  xRecall, xField, and xCompute give incorrect results whenyou
  83.      execute them using XQL.EXE 2.11a.
  84.  
  85.      Developing Your Application with Other Languages
  86.  
  87.      The NWSQLAPI.H file provides the information you need to determine how to
  88.      call the various functions in WXQLCALL.DLL.  For more information on
  89.      calling Dynamic Link Library (DLL) functions, consult their language
  90.      reference for your compiler.
  91.  
  92.          File                    Description
  93.  
  94.      ■XQLWRQ.TXT    The document you are reading
  95.  
  96.      ■WXQLCALL.DLL  NetWare SQL Requester interface for Windows 3.00c
  97.  
  98.      ■WXQLCALL.LIB  Library containing symbols that the developer must link
  99.                     with the application (if developing with C).
  100.  
  101.      ■NWSQLAPI.H    Include file containing prototypes of XQL APIs.
  102.  
  103.      ■NWSQLINT.H    Include file containing environment configuration
  104.                     parameters.
  105.  
  106.      NetWare SQL is a trademark of Novell, Inc.
  107.      NetWire is a service mark of Novell, Inc.
  108.      Windows is a trademark of Microsoft Corporation.
  109.  
  110.      Self-Extracting File Name:  XQLWRQ.EXE     Revision:  B
  111.  
  112.      Files Included    Size      Date      Time     Version
  113.  
  114.      \
  115.        XQLWRQ.TXT           (This file)
  116.      WXQLCALL.DLL      18432   10-26-93    3:42p   3.00c
  117.      WXQLCALL.LIB       4608   10-21-93   11:28a   3.00c
  118.      NWSQLAPI.H         5999   12-03-91    5:00p
  119.      NWSQLINT.H         4087   03-11-92    3:40p
  120.  
  121.      Installation Instructions:
  122.  
  123.      Installing and Using WXQLCALL.DLL 3.00c with XQL 2.11
  124.  
  125.      1.   Before using WXQLCALL.DLL with XQL, apply optional patch 38 to
  126.           XQL.EXE, XQLO.EXE, XQLP.EXE, or XQLPO.EXE (whichever one you are
  127.           running).
  128.  
  129.      2.   Initialize WXQLCALL.DLL in the [NSREQDPMI] section of the NOVDB.INI
  130.           file.  The default parameters for this section are as follows:
  131.  
  132.           [NSREQDPMI]
  133.           datalength=4096     ; same as the /W: option used for XQL
  134.           views=8             ; same as the /V: option used for XQL
  135.           tasks=2             ; maximum tasks that can use WXQLCALL.DLL
  136.                               concurrently
  137.  
  138.           Note:  The value for the datalength option must equal or exceed the
  139.           size of the largest record being accessed.
  140.  
  141.      4.   Load Btrieve and XQL before starting Windows, or place the commands
  142.           to load Btrieve and XQL in the WINSTART.BAT file.  (You can use the
  143.           latter method only if you are using Windows in enhanced mode.) 
  144.           Windows must be able to locate WXQLCALL.DLL.
  145.  
  146.           Note: If you do not load Btrieve and XQL in WINSTART.BAT, you must
  147.           load them before loading Windows.  Otherwise, your application
  148.           receives Status Code 2112.
  149.  
  150.           ■    To unload WXQLCALL.DLL, an XQL application running in Windows
  151.                must call xStop or XQLStop before terminating.
  152.  
  153.           ■    If you loaded Btrieve and XQL before starting Windows, make
  154.                sure all Windows tasks have exited, then unload Windows before
  155.                unloading XQL and Btrieve.  Unload XQL by issuing the XQLUTIL
  156.                -STOP command from the DOS prompt.  Unload Btrieve by issuing
  157.                the BUTIL -STOP command from the DOS prompt.
  158.  
  159.           ■    If you loaded Btrieve and XQL using the WINSTART.BAT file,
  160.                Windows unloads them when you exit the Windows environment.
  161.